---
layout: "default"
title: "Operator: -"
description: "Swift documentation for the '-' operator."
root: "/v4.2"
---

<code class="language-swift"> operator - {
    associativity left
    precedence 
}</code>

<h3>Declarations</h3>

<div class="declaration" id="func-mns_-double-rhs_-double">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-double-rhs_-double">func -(<wbr>_:<wbr> Double, rhs: Double)</a>
        
<div class="comment collapse" id="comment-func-mns_-double-rhs_-double"><div class="p">
    <p>Subtracts one value from another and produces their difference, rounded
to a representable value.</p>

<p>The subtraction operator (<code>-</code>) calculates the difference of its two
arguments. For example:</p>

<pre><code class="language-swift">let x = 7.5
let y = x - 2.25
// y == 5.25</code></pre>

<p>The <code>-</code> operator implements the subtraction operation defined by the
<a href="http://ieeexplore.ieee.org/servlet/opac?punumber=4610933">IEEE 754 specification</a>.</p>

<p><strong>Parameters:</strong>
  <strong>lhs:</strong> A numeric value.
  <strong>rhs:</strong> The value to subtract from <code>lhs</code>.</p>

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: Double, rhs: Double) -&gt; Double</code>
    
    
</div></div>
</div>
<div class="declaration" id="func-mns_-float-rhs_-float">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-float-rhs_-float">func -(<wbr>_:<wbr> Float, rhs: Float)</a>
        
<div class="comment collapse" id="comment-func-mns_-float-rhs_-float"><div class="p">
    <p>Subtracts one value from another and produces their difference, rounded
to a representable value.</p>

<p>The subtraction operator (<code>-</code>) calculates the difference of its two
arguments. For example:</p>

<pre><code class="language-swift">let x = 7.5
let y = x - 2.25
// y == 5.25</code></pre>

<p>The <code>-</code> operator implements the subtraction operation defined by the
<a href="http://ieeexplore.ieee.org/servlet/opac?punumber=4610933">IEEE 754 specification</a>.</p>

<p><strong>Parameters:</strong>
  <strong>lhs:</strong> A numeric value.
  <strong>rhs:</strong> The value to subtract from <code>lhs</code>.</p>

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: Float, rhs: Float) -&gt; Float</code>
    
    
</div></div>
</div>
<div class="declaration" id="func-mns_-float80-rhs_-float80">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-float80-rhs_-float80">func -(<wbr>_:<wbr> Float80, rhs: Float80)</a>
        
<div class="comment collapse" id="comment-func-mns_-float80-rhs_-float80"><div class="p">
    <p>Subtracts one value from another and produces their difference, rounded
to a representable value.</p>

<p>The subtraction operator (<code>-</code>) calculates the difference of its two
arguments. For example:</p>

<pre><code class="language-swift">let x = 7.5
let y = x - 2.25
// y == 5.25</code></pre>

<p>The <code>-</code> operator implements the subtraction operation defined by the
<a href="http://ieeexplore.ieee.org/servlet/opac?punumber=4610933">IEEE 754 specification</a>.</p>

<p><strong>Parameters:</strong>
  <strong>lhs:</strong> A numeric value.
  <strong>rhs:</strong> The value to subtract from <code>lhs</code>.</p>

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: Float80, rhs: Float80) -&gt; Float80</code>
    
    
</div></div>
</div>
<div class="declaration" id="func-mns_-int-rhs_-int">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-int-rhs_-int">func -(<wbr>_:<wbr> Int, rhs: Int)</a>
        
<div class="comment collapse" id="comment-func-mns_-int-rhs_-int"><div class="p">
    <p>Subtracts one value from another and produces their difference.</p>

<p>The subtraction operator (<code>-</code>) calculates the difference of its two
arguments. For example:</p>

<pre><code class="language-swift">8 - 3                   // 5
-10 - 5                 // -15
100 - -5                // 105
10.5 - 100.0            // -89.5</code></pre>

<p>You cannot use <code>-</code> with arguments of different types. To subtract values
of different types, convert one of the values to the other value&#39;s type.</p>

<pre><code class="language-swift">let x: UInt8 = 21
let y: UInt = 1000000
y - UInt(x)             // 999979</code></pre>

<p>The difference of the two arguments must be representable in the
arguments&#39; type. In the following example, the result of <code>21 - 50</code> is
less than zero, the minimum representable <code>UInt8</code> value:</p>

<pre><code class="language-swift">x - 50                  // Overflow error</code></pre>

<p><strong>Note:</strong> Overflow checking is not performed in <code>-Ounchecked</code> builds.</p>

<p>If you want to opt out of overflow checking and ignore any overflow, use
the overflow subtraction operator (<code>&amp;-</code>).</p>

<pre><code class="language-swift">x &amp;- 50                // 227</code></pre>

<p><strong>Parameters:</strong>
  <strong>lhs:</strong> A numeric value.
  <strong>rhs:</strong> The value to subtract from <code>lhs</code>.</p>

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: Int, rhs: Int) -&gt; Int</code>
    
    
</div></div>
</div>
<div class="declaration" id="func-mns_-int8-rhs_-int8">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-int8-rhs_-int8">func -(<wbr>_:<wbr> Int8, rhs: Int8)</a>
        
<div class="comment collapse" id="comment-func-mns_-int8-rhs_-int8"><div class="p">
    <p>Subtracts one value from another and produces their difference.</p>

<p>The subtraction operator (<code>-</code>) calculates the difference of its two
arguments. For example:</p>

<pre><code class="language-swift">8 - 3                   // 5
-10 - 5                 // -15
100 - -5                // 105
10.5 - 100.0            // -89.5</code></pre>

<p>You cannot use <code>-</code> with arguments of different types. To subtract values
of different types, convert one of the values to the other value&#39;s type.</p>

<pre><code class="language-swift">let x: UInt8 = 21
let y: UInt = 1000000
y - UInt(x)             // 999979</code></pre>

<p>The difference of the two arguments must be representable in the
arguments&#39; type. In the following example, the result of <code>21 - 50</code> is
less than zero, the minimum representable <code>UInt8</code> value:</p>

<pre><code class="language-swift">x - 50                  // Overflow error</code></pre>

<p><strong>Note:</strong> Overflow checking is not performed in <code>-Ounchecked</code> builds.</p>

<p>If you want to opt out of overflow checking and ignore any overflow, use
the overflow subtraction operator (<code>&amp;-</code>).</p>

<pre><code class="language-swift">x &amp;- 50                // 227</code></pre>

<p><strong>Parameters:</strong>
  <strong>lhs:</strong> A numeric value.
  <strong>rhs:</strong> The value to subtract from <code>lhs</code>.</p>

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: Int8, rhs: Int8) -&gt; Int8</code>
    
    
</div></div>
</div>
<div class="declaration" id="func-mns_-int16-rhs_-int16">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-int16-rhs_-int16">func -(<wbr>_:<wbr> Int16, rhs: Int16)</a>
        
<div class="comment collapse" id="comment-func-mns_-int16-rhs_-int16"><div class="p">
    <p>Subtracts one value from another and produces their difference.</p>

<p>The subtraction operator (<code>-</code>) calculates the difference of its two
arguments. For example:</p>

<pre><code class="language-swift">8 - 3                   // 5
-10 - 5                 // -15
100 - -5                // 105
10.5 - 100.0            // -89.5</code></pre>

<p>You cannot use <code>-</code> with arguments of different types. To subtract values
of different types, convert one of the values to the other value&#39;s type.</p>

<pre><code class="language-swift">let x: UInt8 = 21
let y: UInt = 1000000
y - UInt(x)             // 999979</code></pre>

<p>The difference of the two arguments must be representable in the
arguments&#39; type. In the following example, the result of <code>21 - 50</code> is
less than zero, the minimum representable <code>UInt8</code> value:</p>

<pre><code class="language-swift">x - 50                  // Overflow error</code></pre>

<p><strong>Note:</strong> Overflow checking is not performed in <code>-Ounchecked</code> builds.</p>

<p>If you want to opt out of overflow checking and ignore any overflow, use
the overflow subtraction operator (<code>&amp;-</code>).</p>

<pre><code class="language-swift">x &amp;- 50                // 227</code></pre>

<p><strong>Parameters:</strong>
  <strong>lhs:</strong> A numeric value.
  <strong>rhs:</strong> The value to subtract from <code>lhs</code>.</p>

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: Int16, rhs: Int16) -&gt; Int16</code>
    
    
</div></div>
</div>
<div class="declaration" id="func-mns_-int32-rhs_-int32">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-int32-rhs_-int32">func -(<wbr>_:<wbr> Int32, rhs: Int32)</a>
        
<div class="comment collapse" id="comment-func-mns_-int32-rhs_-int32"><div class="p">
    <p>Subtracts one value from another and produces their difference.</p>

<p>The subtraction operator (<code>-</code>) calculates the difference of its two
arguments. For example:</p>

<pre><code class="language-swift">8 - 3                   // 5
-10 - 5                 // -15
100 - -5                // 105
10.5 - 100.0            // -89.5</code></pre>

<p>You cannot use <code>-</code> with arguments of different types. To subtract values
of different types, convert one of the values to the other value&#39;s type.</p>

<pre><code class="language-swift">let x: UInt8 = 21
let y: UInt = 1000000
y - UInt(x)             // 999979</code></pre>

<p>The difference of the two arguments must be representable in the
arguments&#39; type. In the following example, the result of <code>21 - 50</code> is
less than zero, the minimum representable <code>UInt8</code> value:</p>

<pre><code class="language-swift">x - 50                  // Overflow error</code></pre>

<p><strong>Note:</strong> Overflow checking is not performed in <code>-Ounchecked</code> builds.</p>

<p>If you want to opt out of overflow checking and ignore any overflow, use
the overflow subtraction operator (<code>&amp;-</code>).</p>

<pre><code class="language-swift">x &amp;- 50                // 227</code></pre>

<p><strong>Parameters:</strong>
  <strong>lhs:</strong> A numeric value.
  <strong>rhs:</strong> The value to subtract from <code>lhs</code>.</p>

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: Int32, rhs: Int32) -&gt; Int32</code>
    
    
</div></div>
</div>
<div class="declaration" id="func-mns_-int64-rhs_-int64">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-int64-rhs_-int64">func -(<wbr>_:<wbr> Int64, rhs: Int64)</a>
        
<div class="comment collapse" id="comment-func-mns_-int64-rhs_-int64"><div class="p">
    <p>Subtracts one value from another and produces their difference.</p>

<p>The subtraction operator (<code>-</code>) calculates the difference of its two
arguments. For example:</p>

<pre><code class="language-swift">8 - 3                   // 5
-10 - 5                 // -15
100 - -5                // 105
10.5 - 100.0            // -89.5</code></pre>

<p>You cannot use <code>-</code> with arguments of different types. To subtract values
of different types, convert one of the values to the other value&#39;s type.</p>

<pre><code class="language-swift">let x: UInt8 = 21
let y: UInt = 1000000
y - UInt(x)             // 999979</code></pre>

<p>The difference of the two arguments must be representable in the
arguments&#39; type. In the following example, the result of <code>21 - 50</code> is
less than zero, the minimum representable <code>UInt8</code> value:</p>

<pre><code class="language-swift">x - 50                  // Overflow error</code></pre>

<p><strong>Note:</strong> Overflow checking is not performed in <code>-Ounchecked</code> builds.</p>

<p>If you want to opt out of overflow checking and ignore any overflow, use
the overflow subtraction operator (<code>&amp;-</code>).</p>

<pre><code class="language-swift">x &amp;- 50                // 227</code></pre>

<p><strong>Parameters:</strong>
  <strong>lhs:</strong> A numeric value.
  <strong>rhs:</strong> The value to subtract from <code>lhs</code>.</p>

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: Int64, rhs: Int64) -&gt; Int64</code>
    
    
</div></div>
</div>
<div class="declaration inherited" id="func-mns_-self-rhs_-self">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-self-rhs_-self">func -(<wbr>_:<wbr> Self, rhs: Self)</a>
        
<div class="comment collapse" id="comment-func-mns_-self-rhs_-self"><div class="p">
    <p>Subtracts one value from another and produces their difference.</p>

<p>The subtraction operator (<code>-</code>) calculates the difference of its two
arguments. For example:</p>

<pre><code class="language-swift">8 - 3                   // 5
-10 - 5                 // -15
100 - -5                // 105
10.5 - 100.0            // -89.5</code></pre>

<p>You cannot use <code>-</code> with arguments of different types. To subtract values
of different types, convert one of the values to the other value&#39;s type.</p>

<pre><code class="language-swift">let x: UInt8 = 21
let y: UInt = 1000000
y - UInt(x)             // 999979</code></pre>

<p><strong>Parameters:</strong>
  <strong>lhs:</strong> A numeric value.
  <strong>rhs:</strong> The value to subtract from <code>lhs</code>.</p>

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: Self, rhs: Self) -&gt; Self.Stride</code>
    
        <h4>Declared In</h4>
        <a href="../../protocol/FixedWidthInteger/"><code>FixedWidthInteger</code></a>    
</div></div>
</div>
<div class="declaration inherited" id="func-mns_-self-rhs_-self">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-self-rhs_-self">func -(<wbr>_:<wbr> Self, rhs: Self)</a>
        
<div class="comment collapse" id="comment-func-mns_-self-rhs_-self"><div class="p">
    <p>Subtracts one value from another and produces their difference.</p>

<p>The subtraction operator (<code>-</code>) calculates the difference of its two
arguments. For example:</p>

<pre><code class="language-swift">8 - 3                   // 5
-10 - 5                 // -15
100 - -5                // 105
10.5 - 100.0            // -89.5</code></pre>

<p>You cannot use <code>-</code> with arguments of different types. To subtract values
of different types, convert one of the values to the other value&#39;s type.</p>

<pre><code class="language-swift">let x: UInt8 = 21
let y: UInt = 1000000
y - UInt(x)             // 999979</code></pre>

<p><strong>Parameters:</strong>
  <strong>lhs:</strong> A numeric value.
  <strong>rhs:</strong> The value to subtract from <code>lhs</code>.</p>

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: Self, rhs: Self) -&gt; Self.Stride</code>
    
        <h4>Declared In</h4>
        <a href="../../protocol/FixedWidthInteger/"><code>FixedWidthInteger</code></a>    
</div></div>
</div>
<div class="declaration inherited" id="func-mns_-self-rhs_-self">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-self-rhs_-self">func -(<wbr>_:<wbr> Self, rhs: Self)</a>
        
<div class="comment collapse" id="comment-func-mns_-self-rhs_-self"><div class="p">
    <p>Subtracts one value from another and produces their difference.</p>

<p>The subtraction operator (<code>-</code>) calculates the difference of its two
arguments. For example:</p>

<pre><code class="language-swift">8 - 3                   // 5
-10 - 5                 // -15
100 - -5                // 105
10.5 - 100.0            // -89.5</code></pre>

<p>You cannot use <code>-</code> with arguments of different types. To subtract values
of different types, convert one of the values to the other value&#39;s type.</p>

<pre><code class="language-swift">let x: UInt8 = 21
let y: UInt = 1000000
y - UInt(x)             // 999979</code></pre>

<p><strong>Parameters:</strong>
  <strong>lhs:</strong> A numeric value.
  <strong>rhs:</strong> The value to subtract from <code>lhs</code>.</p>

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: Self, rhs: Self) -&gt; Self.Stride</code>
    
        <h4>Declared In</h4>
        <a href="../../protocol/FixedWidthInteger/"><code>FixedWidthInteger</code></a>    
</div></div>
</div>
<div class="declaration inherited" id="func-mns_-self-rhs_-self">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-self-rhs_-self">func -(<wbr>_:<wbr> Self, rhs: Self)</a>
        
<div class="comment collapse" id="comment-func-mns_-self-rhs_-self"><div class="p">
    <p>Subtracts one value from another and produces their difference.</p>

<p>The subtraction operator (<code>-</code>) calculates the difference of its two
arguments. For example:</p>

<pre><code class="language-swift">8 - 3                   // 5
-10 - 5                 // -15
100 - -5                // 105
10.5 - 100.0            // -89.5</code></pre>

<p>You cannot use <code>-</code> with arguments of different types. To subtract values
of different types, convert one of the values to the other value&#39;s type.</p>

<pre><code class="language-swift">let x: UInt8 = 21
let y: UInt = 1000000
y - UInt(x)             // 999979</code></pre>

<p><strong>Parameters:</strong>
  <strong>lhs:</strong> A numeric value.
  <strong>rhs:</strong> The value to subtract from <code>lhs</code>.</p>

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: Self, rhs: Self) -&gt; Self.Stride</code>
    
        <h4>Declared In</h4>
        <a href="../../protocol/FixedWidthInteger/"><code>FixedWidthInteger</code></a>    
</div></div>
</div>
<div class="declaration inherited" id="func-mns_-self-rhs_-self">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-self-rhs_-self">func -(<wbr>_:<wbr> Self, rhs: Self)</a>
        
<div class="comment collapse" id="comment-func-mns_-self-rhs_-self"><div class="p">
    <p>Subtracts one value from another and produces their difference, rounded
to a representable value.</p>

<p>The subtraction operator (<code>-</code>) calculates the difference of its two
arguments. For example:</p>

<pre><code class="language-swift">let x = 7.5
let y = x - 2.25
// y == 5.25</code></pre>

<p>The <code>-</code> operator implements the subtraction operation defined by the
<a href="http://ieeexplore.ieee.org/servlet/opac?punumber=4610933">IEEE 754 specification</a>.</p>

<p><strong>Parameters:</strong>
  <strong>lhs:</strong> A numeric value.
  <strong>rhs:</strong> The value to subtract from <code>lhs</code>.</p>

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: Self, rhs: Self) -&gt; Self.Stride</code>
    
        <h4>Declared In</h4>
        <a href="../../protocol/BinaryFloatingPoint/"><code>BinaryFloatingPoint</code></a>,    <a href="../../protocol/Strideable/"><code>Strideable</code></a>    
</div></div>
</div>
<div class="declaration inherited" id="func-mns_-self-rhs_-self">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-self-rhs_-self">func -(<wbr>_:<wbr> Self, rhs: Self)</a>
        
<div class="comment collapse" id="comment-func-mns_-self-rhs_-self"><div class="p">
    <p>Subtracts one value from another and produces their difference.</p>

<p>The subtraction operator (<code>-</code>) calculates the difference of its two
arguments. For example:</p>

<pre><code class="language-swift">8 - 3                   // 5
-10 - 5                 // -15
100 - -5                // 105
10.5 - 100.0            // -89.5</code></pre>

<p>You cannot use <code>-</code> with arguments of different types. To subtract values
of different types, convert one of the values to the other value&#39;s type.</p>

<pre><code class="language-swift">let x: UInt8 = 21
let y: UInt = 1000000
y - UInt(x)             // 999979</code></pre>

<p><strong>Parameters:</strong>
  <strong>lhs:</strong> A numeric value.
  <strong>rhs:</strong> The value to subtract from <code>lhs</code>.</p>

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: Self, rhs: Self) -&gt; Self.Stride</code>
    
        <h4>Declared In</h4>
        <a href="../../protocol/FixedWidthInteger/"><code>FixedWidthInteger</code></a>    
</div></div>
</div>
<div class="declaration inherited" id="func-mns_-self-rhs_-self">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-self-rhs_-self">func -(<wbr>_:<wbr> Self, rhs: Self)</a>
        
<div class="comment collapse" id="comment-func-mns_-self-rhs_-self"><div class="p">
    <p>Subtracts one value from another and produces their difference.</p>

<p>The subtraction operator (<code>-</code>) calculates the difference of its two
arguments. For example:</p>

<pre><code class="language-swift">8 - 3                   // 5
-10 - 5                 // -15
100 - -5                // 105
10.5 - 100.0            // -89.5</code></pre>

<p>You cannot use <code>-</code> with arguments of different types. To subtract values
of different types, convert one of the values to the other value&#39;s type.</p>

<pre><code class="language-swift">let x: UInt8 = 21
let y: UInt = 1000000
y - UInt(x)             // 999979</code></pre>

<p><strong>Parameters:</strong>
  <strong>lhs:</strong> A numeric value.
  <strong>rhs:</strong> The value to subtract from <code>lhs</code>.</p>

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: Self, rhs: Self) -&gt; Self.Stride</code>
    
        <h4>Declared In</h4>
        <a href="../../protocol/FixedWidthInteger/"><code>FixedWidthInteger</code></a>    
</div></div>
</div>
<div class="declaration inherited" id="func-mns_-self-rhs_-self">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-self-rhs_-self">func -(<wbr>_:<wbr> Self, rhs: Self)</a>
        
<div class="comment collapse" id="comment-func-mns_-self-rhs_-self"><div class="p">
    <p>Subtracts one value from another and produces their difference.</p>

<p>The subtraction operator (<code>-</code>) calculates the difference of its two
arguments. For example:</p>

<pre><code class="language-swift">8 - 3                   // 5
-10 - 5                 // -15
100 - -5                // 105
10.5 - 100.0            // -89.5</code></pre>

<p>You cannot use <code>-</code> with arguments of different types. To subtract values
of different types, convert one of the values to the other value&#39;s type.</p>

<pre><code class="language-swift">let x: UInt8 = 21
let y: UInt = 1000000
y - UInt(x)             // 999979</code></pre>

<p><strong>Parameters:</strong>
  <strong>lhs:</strong> A numeric value.
  <strong>rhs:</strong> The value to subtract from <code>lhs</code>.</p>

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: Self, rhs: Self) -&gt; Self.Stride</code>
    
        <h4>Declared In</h4>
        <a href="../../protocol/FixedWidthInteger/"><code>FixedWidthInteger</code></a>    
</div></div>
</div>
<div class="declaration inherited" id="func-mns_-self-rhs_-self">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-self-rhs_-self">func -(<wbr>_:<wbr> Self, rhs: Self)</a>
        
<div class="comment collapse" id="comment-func-mns_-self-rhs_-self"><div class="p">
    

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: Self, rhs: Self) -&gt; Self.Stride</code>
    
        <h4>Declared In</h4>
        <a href="../../protocol/Strideable/"><code>Strideable</code></a>    
</div></div>
</div>
<div class="declaration inherited" id="func-mns_-self-rhs_-self">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-self-rhs_-self">func -(<wbr>_:<wbr> Self, rhs: Self)</a>
        
<div class="comment collapse" id="comment-func-mns_-self-rhs_-self"><div class="p">
    <p>Subtracts one value from another and produces their difference.</p>

<p>The subtraction operator (<code>-</code>) calculates the difference of its two
arguments. For example:</p>

<pre><code class="language-swift">8 - 3                   // 5
-10 - 5                 // -15
100 - -5                // 105
10.5 - 100.0            // -89.5</code></pre>

<p>You cannot use <code>-</code> with arguments of different types. To subtract values
of different types, convert one of the values to the other value&#39;s type.</p>

<pre><code class="language-swift">let x: UInt8 = 21
let y: UInt = 1000000
y - UInt(x)             // 999979</code></pre>

<p><strong>Parameters:</strong>
  <strong>lhs:</strong> A numeric value.
  <strong>rhs:</strong> The value to subtract from <code>lhs</code>.</p>

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: Self, rhs: Self) -&gt; Self.Stride</code>
    
        <h4>Declared In</h4>
        <a href="../../protocol/FixedWidthInteger/"><code>FixedWidthInteger</code></a>    
</div></div>
</div>
<div class="declaration inherited" id="func-mns_-self-rhs_-self">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-self-rhs_-self">func -(<wbr>_:<wbr> Self, rhs: Self)</a>
        
<div class="comment collapse" id="comment-func-mns_-self-rhs_-self"><div class="p">
    <p>Subtracts one value from another and produces their difference.</p>

<p>The subtraction operator (<code>-</code>) calculates the difference of its two
arguments. For example:</p>

<pre><code class="language-swift">8 - 3                   // 5
-10 - 5                 // -15
100 - -5                // 105
10.5 - 100.0            // -89.5</code></pre>

<p>You cannot use <code>-</code> with arguments of different types. To subtract values
of different types, convert one of the values to the other value&#39;s type.</p>

<pre><code class="language-swift">let x: UInt8 = 21
let y: UInt = 1000000
y - UInt(x)             // 999979</code></pre>

<p><strong>Parameters:</strong>
  <strong>lhs:</strong> A numeric value.
  <strong>rhs:</strong> The value to subtract from <code>lhs</code>.</p>

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: Self, rhs: Self) -&gt; Self.Stride</code>
    
        <h4>Declared In</h4>
        <a href="../../protocol/FixedWidthInteger/"><code>FixedWidthInteger</code></a>    
</div></div>
</div>
<div class="declaration inherited" id="func-mns_-self-rhs_-self">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-self-rhs_-self">func -(<wbr>_:<wbr> Self, rhs: Self)</a>
        
<div class="comment collapse" id="comment-func-mns_-self-rhs_-self"><div class="p">
    

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: Self, rhs: Self) -&gt; Self.Stride</code>
    
        <h4>Declared In</h4>
        <a href="../../protocol/Strideable/"><code>Strideable</code></a>    
</div></div>
</div>
<div class="declaration inherited" id="func-mns_-self-rhs_-self">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-self-rhs_-self">func -(<wbr>_:<wbr> Self, rhs: Self)</a>
        
<div class="comment collapse" id="comment-func-mns_-self-rhs_-self"><div class="p">
    <p>Subtracts one value from another and produces their difference.</p>

<p>The subtraction operator (<code>-</code>) calculates the difference of its two
arguments. For example:</p>

<pre><code class="language-swift">8 - 3                   // 5
-10 - 5                 // -15
100 - -5                // 105
10.5 - 100.0            // -89.5</code></pre>

<p>You cannot use <code>-</code> with arguments of different types. To subtract values
of different types, convert one of the values to the other value&#39;s type.</p>

<pre><code class="language-swift">let x: UInt8 = 21
let y: UInt = 1000000
y - UInt(x)             // 999979</code></pre>

<p><strong>Parameters:</strong>
  <strong>lhs:</strong> A numeric value.
  <strong>rhs:</strong> The value to subtract from <code>lhs</code>.</p>

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: Self, rhs: Self) -&gt; Self.Stride</code>
    
        <h4>Declared In</h4>
        <a href="../../protocol/FixedWidthInteger/"><code>FixedWidthInteger</code></a>    
</div></div>
</div>
<div class="declaration inherited" id="func-mns_-self-rhs_-self">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-self-rhs_-self">func -(<wbr>_:<wbr> Self, rhs: Self)</a>
        
<div class="comment collapse" id="comment-func-mns_-self-rhs_-self"><div class="p">
    

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: Self, rhs: Self) -&gt; Self.Stride</code>
    
        <h4>Declared In</h4>
        <a href="../../protocol/Strideable/"><code>Strideable</code></a>    
</div></div>
</div>
<div class="declaration inherited" id="func-mns_-self-rhs_-self">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-self-rhs_-self">func -(<wbr>_:<wbr> Self, rhs: Self)</a>
        
<div class="comment collapse" id="comment-func-mns_-self-rhs_-self"><div class="p">
    

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: Self, rhs: Self) -&gt; Self.Stride</code>
    
        <h4>Declared In</h4>
        <a href="../../protocol/Strideable/"><code>Strideable</code></a>    
</div></div>
</div>
<div class="declaration inherited" id="func-mns_-self-rhs_-self">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-self-rhs_-self">func -(<wbr>_:<wbr> Self, rhs: Self)</a>
        
<div class="comment collapse" id="comment-func-mns_-self-rhs_-self"><div class="p">
    

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: Self, rhs: Self) -&gt; Self.Stride</code>
    
        <h4>Declared In</h4>
        <a href="../../protocol/Strideable/"><code>Strideable</code></a>    
</div></div>
</div>
<div class="declaration inherited" id="func-mns_-self-rhs_-self-stride">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-self-rhs_-self-stride">func -(<wbr>_:<wbr> Self, rhs: Self.Stride)</a>
        
<div class="comment collapse" id="comment-func-mns_-self-rhs_-self-stride"><div class="p">
    <p>Subtracts one value from another and produces their difference.</p>

<p>The subtraction operator (<code>-</code>) calculates the difference of its two
arguments. For example:</p>

<pre><code class="language-swift">8 - 3                   // 5
-10 - 5                 // -15
100 - -5                // 105
10.5 - 100.0            // -89.5</code></pre>

<p>You cannot use <code>-</code> with arguments of different types. To subtract values
of different types, convert one of the values to the other value&#39;s type.</p>

<pre><code class="language-swift">let x: UInt8 = 21
let y: UInt = 1000000
y - UInt(x)             // 999979</code></pre>

<p><strong>Parameters:</strong>
  <strong>lhs:</strong> A numeric value.
  <strong>rhs:</strong> The value to subtract from <code>lhs</code>.</p>

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: Self, rhs: Self.Stride) -&gt; Self</code>
    
        <h4>Declared In</h4>
        <a href="../../protocol/FixedWidthInteger/"><code>FixedWidthInteger</code></a>    
</div></div>
</div>
<div class="declaration inherited" id="func-mns_-self-rhs_-self-stride">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-self-rhs_-self-stride">func -(<wbr>_:<wbr> Self, rhs: Self.Stride)</a>
        
<div class="comment collapse" id="comment-func-mns_-self-rhs_-self-stride"><div class="p">
    <p>Subtracts one value from another and produces their difference.</p>

<p>The subtraction operator (<code>-</code>) calculates the difference of its two
arguments. For example:</p>

<pre><code class="language-swift">8 - 3                   // 5
-10 - 5                 // -15
100 - -5                // 105
10.5 - 100.0            // -89.5</code></pre>

<p>You cannot use <code>-</code> with arguments of different types. To subtract values
of different types, convert one of the values to the other value&#39;s type.</p>

<pre><code class="language-swift">let x: UInt8 = 21
let y: UInt = 1000000
y - UInt(x)             // 999979</code></pre>

<p><strong>Parameters:</strong>
  <strong>lhs:</strong> A numeric value.
  <strong>rhs:</strong> The value to subtract from <code>lhs</code>.</p>

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: Self, rhs: Self.Stride) -&gt; Self</code>
    
        <h4>Declared In</h4>
        <a href="../../protocol/FixedWidthInteger/"><code>FixedWidthInteger</code></a>    
</div></div>
</div>
<div class="declaration inherited" id="func-mns_-self-rhs_-self-stride">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-self-rhs_-self-stride">func -(<wbr>_:<wbr> Self, rhs: Self.Stride)</a>
        
<div class="comment collapse" id="comment-func-mns_-self-rhs_-self-stride"><div class="p">
    

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: Self, rhs: Self.Stride) -&gt; Self</code>
    
        <h4>Declared In</h4>
        <a href="../../protocol/Strideable/"><code>Strideable</code></a>    
</div></div>
</div>
<div class="declaration inherited" id="func-mns_-self-rhs_-self-stride">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-self-rhs_-self-stride">func -(<wbr>_:<wbr> Self, rhs: Self.Stride)</a>
        
<div class="comment collapse" id="comment-func-mns_-self-rhs_-self-stride"><div class="p">
    <p>Subtracts one value from another and produces their difference.</p>

<p>The subtraction operator (<code>-</code>) calculates the difference of its two
arguments. For example:</p>

<pre><code class="language-swift">8 - 3                   // 5
-10 - 5                 // -15
100 - -5                // 105
10.5 - 100.0            // -89.5</code></pre>

<p>You cannot use <code>-</code> with arguments of different types. To subtract values
of different types, convert one of the values to the other value&#39;s type.</p>

<pre><code class="language-swift">let x: UInt8 = 21
let y: UInt = 1000000
y - UInt(x)             // 999979</code></pre>

<p><strong>Parameters:</strong>
  <strong>lhs:</strong> A numeric value.
  <strong>rhs:</strong> The value to subtract from <code>lhs</code>.</p>

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: Self, rhs: Self.Stride) -&gt; Self</code>
    
        <h4>Declared In</h4>
        <a href="../../protocol/FixedWidthInteger/"><code>FixedWidthInteger</code></a>    
</div></div>
</div>
<div class="declaration inherited" id="func-mns_-self-rhs_-self-stride">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-self-rhs_-self-stride">func -(<wbr>_:<wbr> Self, rhs: Self.Stride)</a>
        
<div class="comment collapse" id="comment-func-mns_-self-rhs_-self-stride"><div class="p">
    

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: Self, rhs: Self.Stride) -&gt; Self</code>
    
        <h4>Declared In</h4>
        <a href="../../protocol/Strideable/"><code>Strideable</code></a>    
</div></div>
</div>
<div class="declaration inherited" id="func-mns_-self-rhs_-self-stride">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-self-rhs_-self-stride">func -(<wbr>_:<wbr> Self, rhs: Self.Stride)</a>
        
<div class="comment collapse" id="comment-func-mns_-self-rhs_-self-stride"><div class="p">
    <p>Subtracts one value from another and produces their difference.</p>

<p>The subtraction operator (<code>-</code>) calculates the difference of its two
arguments. For example:</p>

<pre><code class="language-swift">8 - 3                   // 5
-10 - 5                 // -15
100 - -5                // 105
10.5 - 100.0            // -89.5</code></pre>

<p>You cannot use <code>-</code> with arguments of different types. To subtract values
of different types, convert one of the values to the other value&#39;s type.</p>

<pre><code class="language-swift">let x: UInt8 = 21
let y: UInt = 1000000
y - UInt(x)             // 999979</code></pre>

<p><strong>Parameters:</strong>
  <strong>lhs:</strong> A numeric value.
  <strong>rhs:</strong> The value to subtract from <code>lhs</code>.</p>

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: Self, rhs: Self.Stride) -&gt; Self</code>
    
        <h4>Declared In</h4>
        <a href="../../protocol/FixedWidthInteger/"><code>FixedWidthInteger</code></a>    
</div></div>
</div>
<div class="declaration inherited" id="func-mns_-self-rhs_-self-stride">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-self-rhs_-self-stride">func -(<wbr>_:<wbr> Self, rhs: Self.Stride)</a>
        
<div class="comment collapse" id="comment-func-mns_-self-rhs_-self-stride"><div class="p">
    <p>Subtracts one value from another and produces their difference.</p>

<p>The subtraction operator (<code>-</code>) calculates the difference of its two
arguments. For example:</p>

<pre><code class="language-swift">8 - 3                   // 5
-10 - 5                 // -15
100 - -5                // 105
10.5 - 100.0            // -89.5</code></pre>

<p>You cannot use <code>-</code> with arguments of different types. To subtract values
of different types, convert one of the values to the other value&#39;s type.</p>

<pre><code class="language-swift">let x: UInt8 = 21
let y: UInt = 1000000
y - UInt(x)             // 999979</code></pre>

<p><strong>Parameters:</strong>
  <strong>lhs:</strong> A numeric value.
  <strong>rhs:</strong> The value to subtract from <code>lhs</code>.</p>

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: Self, rhs: Self.Stride) -&gt; Self</code>
    
        <h4>Declared In</h4>
        <a href="../../protocol/FixedWidthInteger/"><code>FixedWidthInteger</code></a>    
</div></div>
</div>
<div class="declaration inherited" id="func-mns_-self-rhs_-self-stride">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-self-rhs_-self-stride">func -(<wbr>_:<wbr> Self, rhs: Self.Stride)</a>
        
<div class="comment collapse" id="comment-func-mns_-self-rhs_-self-stride"><div class="p">
    <p>Subtracts one value from another and produces their difference.</p>

<p>The subtraction operator (<code>-</code>) calculates the difference of its two
arguments. For example:</p>

<pre><code class="language-swift">8 - 3                   // 5
-10 - 5                 // -15
100 - -5                // 105
10.5 - 100.0            // -89.5</code></pre>

<p>You cannot use <code>-</code> with arguments of different types. To subtract values
of different types, convert one of the values to the other value&#39;s type.</p>

<pre><code class="language-swift">let x: UInt8 = 21
let y: UInt = 1000000
y - UInt(x)             // 999979</code></pre>

<p><strong>Parameters:</strong>
  <strong>lhs:</strong> A numeric value.
  <strong>rhs:</strong> The value to subtract from <code>lhs</code>.</p>

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: Self, rhs: Self.Stride) -&gt; Self</code>
    
        <h4>Declared In</h4>
        <a href="../../protocol/FixedWidthInteger/"><code>FixedWidthInteger</code></a>    
</div></div>
</div>
<div class="declaration inherited" id="func-mns_-self-rhs_-self-stride">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-self-rhs_-self-stride">func -(<wbr>_:<wbr> Self, rhs: Self.Stride)</a>
        
<div class="comment collapse" id="comment-func-mns_-self-rhs_-self-stride"><div class="p">
    <p>Subtracts one value from another and produces their difference, rounded
to a representable value.</p>

<p>The subtraction operator (<code>-</code>) calculates the difference of its two
arguments. For example:</p>

<pre><code class="language-swift">let x = 7.5
let y = x - 2.25
// y == 5.25</code></pre>

<p>The <code>-</code> operator implements the subtraction operation defined by the
<a href="http://ieeexplore.ieee.org/servlet/opac?punumber=4610933">IEEE 754 specification</a>.</p>

<p><strong>Parameters:</strong>
  <strong>lhs:</strong> A numeric value.
  <strong>rhs:</strong> The value to subtract from <code>lhs</code>.</p>

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: Self, rhs: Self.Stride) -&gt; Self</code>
    
        <h4>Declared In</h4>
        <a href="../../protocol/BinaryFloatingPoint/"><code>BinaryFloatingPoint</code></a>,    <a href="../../protocol/Strideable/"><code>Strideable</code></a>    
</div></div>
</div>
<div class="declaration inherited" id="func-mns_-self-rhs_-self-stride">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-self-rhs_-self-stride">func -(<wbr>_:<wbr> Self, rhs: Self.Stride)</a>
        
<div class="comment collapse" id="comment-func-mns_-self-rhs_-self-stride"><div class="p">
    <p>Subtracts one value from another and produces their difference.</p>

<p>The subtraction operator (<code>-</code>) calculates the difference of its two
arguments. For example:</p>

<pre><code class="language-swift">8 - 3                   // 5
-10 - 5                 // -15
100 - -5                // 105
10.5 - 100.0            // -89.5</code></pre>

<p>You cannot use <code>-</code> with arguments of different types. To subtract values
of different types, convert one of the values to the other value&#39;s type.</p>

<pre><code class="language-swift">let x: UInt8 = 21
let y: UInt = 1000000
y - UInt(x)             // 999979</code></pre>

<p><strong>Parameters:</strong>
  <strong>lhs:</strong> A numeric value.
  <strong>rhs:</strong> The value to subtract from <code>lhs</code>.</p>

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: Self, rhs: Self.Stride) -&gt; Self</code>
    
        <h4>Declared In</h4>
        <a href="../../protocol/FixedWidthInteger/"><code>FixedWidthInteger</code></a>    
</div></div>
</div>
<div class="declaration inherited" id="func-mns_-self-rhs_-self-stride">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-self-rhs_-self-stride">func -(<wbr>_:<wbr> Self, rhs: Self.Stride)</a>
        
<div class="comment collapse" id="comment-func-mns_-self-rhs_-self-stride"><div class="p">
    

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: Self, rhs: Self.Stride) -&gt; Self</code>
    
        <h4>Declared In</h4>
        <a href="../../protocol/Strideable/"><code>Strideable</code></a>    
</div></div>
</div>
<div class="declaration inherited" id="func-mns_-self-rhs_-self-stride">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-self-rhs_-self-stride">func -(<wbr>_:<wbr> Self, rhs: Self.Stride)</a>
        
<div class="comment collapse" id="comment-func-mns_-self-rhs_-self-stride"><div class="p">
    <p>Subtracts one value from another and produces their difference.</p>

<p>The subtraction operator (<code>-</code>) calculates the difference of its two
arguments. For example:</p>

<pre><code class="language-swift">8 - 3                   // 5
-10 - 5                 // -15
100 - -5                // 105
10.5 - 100.0            // -89.5</code></pre>

<p>You cannot use <code>-</code> with arguments of different types. To subtract values
of different types, convert one of the values to the other value&#39;s type.</p>

<pre><code class="language-swift">let x: UInt8 = 21
let y: UInt = 1000000
y - UInt(x)             // 999979</code></pre>

<p><strong>Parameters:</strong>
  <strong>lhs:</strong> A numeric value.
  <strong>rhs:</strong> The value to subtract from <code>lhs</code>.</p>

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: Self, rhs: Self.Stride) -&gt; Self</code>
    
        <h4>Declared In</h4>
        <a href="../../protocol/FixedWidthInteger/"><code>FixedWidthInteger</code></a>    
</div></div>
</div>
<div class="declaration inherited" id="func-mns_-self-rhs_-self-stride">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-self-rhs_-self-stride">func -(<wbr>_:<wbr> Self, rhs: Self.Stride)</a>
        
<div class="comment collapse" id="comment-func-mns_-self-rhs_-self-stride"><div class="p">
    

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: Self, rhs: Self.Stride) -&gt; Self</code>
    
        <h4>Declared In</h4>
        <a href="../../protocol/Strideable/"><code>Strideable</code></a>    
</div></div>
</div>
<div class="declaration inherited" id="func-mns_-self-rhs_-self-stride">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-self-rhs_-self-stride">func -(<wbr>_:<wbr> Self, rhs: Self.Stride)</a>
        
<div class="comment collapse" id="comment-func-mns_-self-rhs_-self-stride"><div class="p">
    <p>Subtracts one value from another and produces their difference.</p>

<p>The subtraction operator (<code>-</code>) calculates the difference of its two
arguments. For example:</p>

<pre><code class="language-swift">8 - 3                   // 5
-10 - 5                 // -15
100 - -5                // 105
10.5 - 100.0            // -89.5</code></pre>

<p>You cannot use <code>-</code> with arguments of different types. To subtract values
of different types, convert one of the values to the other value&#39;s type.</p>

<pre><code class="language-swift">let x: UInt8 = 21
let y: UInt = 1000000
y - UInt(x)             // 999979</code></pre>

<p><strong>Parameters:</strong>
  <strong>lhs:</strong> A numeric value.
  <strong>rhs:</strong> The value to subtract from <code>lhs</code>.</p>

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: Self, rhs: Self.Stride) -&gt; Self</code>
    
        <h4>Declared In</h4>
        <a href="../../protocol/FixedWidthInteger/"><code>FixedWidthInteger</code></a>    
</div></div>
</div>
<div class="declaration inherited" id="func-mns_-self-rhs_-self-stride">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-self-rhs_-self-stride">func -(<wbr>_:<wbr> Self, rhs: Self.Stride)</a>
        
<div class="comment collapse" id="comment-func-mns_-self-rhs_-self-stride"><div class="p">
    

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: Self, rhs: Self.Stride) -&gt; Self</code>
    
        <h4>Declared In</h4>
        <a href="../../protocol/Strideable/"><code>Strideable</code></a>    
</div></div>
</div>
<div class="declaration inherited" id="func-mns_-self-rhs_-self-stride">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-self-rhs_-self-stride">func -(<wbr>_:<wbr> Self, rhs: Self.Stride)</a>
        
<div class="comment collapse" id="comment-func-mns_-self-rhs_-self-stride"><div class="p">
    <p>Subtracts one value from another and produces their difference.</p>

<p>The subtraction operator (<code>-</code>) calculates the difference of its two
arguments. For example:</p>

<pre><code class="language-swift">8 - 3                   // 5
-10 - 5                 // -15
100 - -5                // 105
10.5 - 100.0            // -89.5</code></pre>

<p>You cannot use <code>-</code> with arguments of different types. To subtract values
of different types, convert one of the values to the other value&#39;s type.</p>

<pre><code class="language-swift">let x: UInt8 = 21
let y: UInt = 1000000
y - UInt(x)             // 999979</code></pre>

<p><strong>Parameters:</strong>
  <strong>lhs:</strong> A numeric value.
  <strong>rhs:</strong> The value to subtract from <code>lhs</code>.</p>

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: Self, rhs: Self.Stride) -&gt; Self</code>
    
        <h4>Declared In</h4>
        <a href="../../protocol/FixedWidthInteger/"><code>FixedWidthInteger</code></a>    
</div></div>
</div>
<div class="declaration" id="func-mns_-uint-rhs_-uint">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-uint-rhs_-uint">func -(<wbr>_:<wbr> UInt, rhs: UInt)</a>
        
<div class="comment collapse" id="comment-func-mns_-uint-rhs_-uint"><div class="p">
    <p>Subtracts one value from another and produces their difference.</p>

<p>The subtraction operator (<code>-</code>) calculates the difference of its two
arguments. For example:</p>

<pre><code class="language-swift">8 - 3                   // 5
-10 - 5                 // -15
100 - -5                // 105
10.5 - 100.0            // -89.5</code></pre>

<p>You cannot use <code>-</code> with arguments of different types. To subtract values
of different types, convert one of the values to the other value&#39;s type.</p>

<pre><code class="language-swift">let x: UInt8 = 21
let y: UInt = 1000000
y - UInt(x)             // 999979</code></pre>

<p>The difference of the two arguments must be representable in the
arguments&#39; type. In the following example, the result of <code>21 - 50</code> is
less than zero, the minimum representable <code>UInt8</code> value:</p>

<pre><code class="language-swift">x - 50                  // Overflow error</code></pre>

<p><strong>Note:</strong> Overflow checking is not performed in <code>-Ounchecked</code> builds.</p>

<p>If you want to opt out of overflow checking and ignore any overflow, use
the overflow subtraction operator (<code>&amp;-</code>).</p>

<pre><code class="language-swift">x &amp;- 50                // 227</code></pre>

<p><strong>Parameters:</strong>
  <strong>lhs:</strong> A numeric value.
  <strong>rhs:</strong> The value to subtract from <code>lhs</code>.</p>

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: UInt, rhs: UInt) -&gt; UInt</code>
    
    
</div></div>
</div>
<div class="declaration" id="func-mns_-uint8-rhs_-uint8">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-uint8-rhs_-uint8">func -(<wbr>_:<wbr> UInt8, rhs: UInt8)</a>
        
<div class="comment collapse" id="comment-func-mns_-uint8-rhs_-uint8"><div class="p">
    <p>Subtracts one value from another and produces their difference.</p>

<p>The subtraction operator (<code>-</code>) calculates the difference of its two
arguments. For example:</p>

<pre><code class="language-swift">8 - 3                   // 5
-10 - 5                 // -15
100 - -5                // 105
10.5 - 100.0            // -89.5</code></pre>

<p>You cannot use <code>-</code> with arguments of different types. To subtract values
of different types, convert one of the values to the other value&#39;s type.</p>

<pre><code class="language-swift">let x: UInt8 = 21
let y: UInt = 1000000
y - UInt(x)             // 999979</code></pre>

<p>The difference of the two arguments must be representable in the
arguments&#39; type. In the following example, the result of <code>21 - 50</code> is
less than zero, the minimum representable <code>UInt8</code> value:</p>

<pre><code class="language-swift">x - 50                  // Overflow error</code></pre>

<p><strong>Note:</strong> Overflow checking is not performed in <code>-Ounchecked</code> builds.</p>

<p>If you want to opt out of overflow checking and ignore any overflow, use
the overflow subtraction operator (<code>&amp;-</code>).</p>

<pre><code class="language-swift">x &amp;- 50                // 227</code></pre>

<p><strong>Parameters:</strong>
  <strong>lhs:</strong> A numeric value.
  <strong>rhs:</strong> The value to subtract from <code>lhs</code>.</p>

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: UInt8, rhs: UInt8) -&gt; UInt8</code>
    
    
</div></div>
</div>
<div class="declaration" id="func-mns_-uint16-rhs_-uint16">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-uint16-rhs_-uint16">func -(<wbr>_:<wbr> UInt16, rhs: UInt16)</a>
        
<div class="comment collapse" id="comment-func-mns_-uint16-rhs_-uint16"><div class="p">
    <p>Subtracts one value from another and produces their difference.</p>

<p>The subtraction operator (<code>-</code>) calculates the difference of its two
arguments. For example:</p>

<pre><code class="language-swift">8 - 3                   // 5
-10 - 5                 // -15
100 - -5                // 105
10.5 - 100.0            // -89.5</code></pre>

<p>You cannot use <code>-</code> with arguments of different types. To subtract values
of different types, convert one of the values to the other value&#39;s type.</p>

<pre><code class="language-swift">let x: UInt8 = 21
let y: UInt = 1000000
y - UInt(x)             // 999979</code></pre>

<p>The difference of the two arguments must be representable in the
arguments&#39; type. In the following example, the result of <code>21 - 50</code> is
less than zero, the minimum representable <code>UInt8</code> value:</p>

<pre><code class="language-swift">x - 50                  // Overflow error</code></pre>

<p><strong>Note:</strong> Overflow checking is not performed in <code>-Ounchecked</code> builds.</p>

<p>If you want to opt out of overflow checking and ignore any overflow, use
the overflow subtraction operator (<code>&amp;-</code>).</p>

<pre><code class="language-swift">x &amp;- 50                // 227</code></pre>

<p><strong>Parameters:</strong>
  <strong>lhs:</strong> A numeric value.
  <strong>rhs:</strong> The value to subtract from <code>lhs</code>.</p>

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: UInt16, rhs: UInt16) -&gt; UInt16</code>
    
    
</div></div>
</div>
<div class="declaration" id="func-mns_-uint32-rhs_-uint32">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-uint32-rhs_-uint32">func -(<wbr>_:<wbr> UInt32, rhs: UInt32)</a>
        
<div class="comment collapse" id="comment-func-mns_-uint32-rhs_-uint32"><div class="p">
    <p>Subtracts one value from another and produces their difference.</p>

<p>The subtraction operator (<code>-</code>) calculates the difference of its two
arguments. For example:</p>

<pre><code class="language-swift">8 - 3                   // 5
-10 - 5                 // -15
100 - -5                // 105
10.5 - 100.0            // -89.5</code></pre>

<p>You cannot use <code>-</code> with arguments of different types. To subtract values
of different types, convert one of the values to the other value&#39;s type.</p>

<pre><code class="language-swift">let x: UInt8 = 21
let y: UInt = 1000000
y - UInt(x)             // 999979</code></pre>

<p>The difference of the two arguments must be representable in the
arguments&#39; type. In the following example, the result of <code>21 - 50</code> is
less than zero, the minimum representable <code>UInt8</code> value:</p>

<pre><code class="language-swift">x - 50                  // Overflow error</code></pre>

<p><strong>Note:</strong> Overflow checking is not performed in <code>-Ounchecked</code> builds.</p>

<p>If you want to opt out of overflow checking and ignore any overflow, use
the overflow subtraction operator (<code>&amp;-</code>).</p>

<pre><code class="language-swift">x &amp;- 50                // 227</code></pre>

<p><strong>Parameters:</strong>
  <strong>lhs:</strong> A numeric value.
  <strong>rhs:</strong> The value to subtract from <code>lhs</code>.</p>

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: UInt32, rhs: UInt32) -&gt; UInt32</code>
    
    
</div></div>
</div>
<div class="declaration" id="func-mns_-uint64-rhs_-uint64">
<a class="toggle-link" data-toggle="collapse" href="#comment-func-mns_-uint64-rhs_-uint64">func -(<wbr>_:<wbr> UInt64, rhs: UInt64)</a>
        
<div class="comment collapse" id="comment-func-mns_-uint64-rhs_-uint64"><div class="p">
    <p>Subtracts one value from another and produces their difference.</p>

<p>The subtraction operator (<code>-</code>) calculates the difference of its two
arguments. For example:</p>

<pre><code class="language-swift">8 - 3                   // 5
-10 - 5                 // -15
100 - -5                // 105
10.5 - 100.0            // -89.5</code></pre>

<p>You cannot use <code>-</code> with arguments of different types. To subtract values
of different types, convert one of the values to the other value&#39;s type.</p>

<pre><code class="language-swift">let x: UInt8 = 21
let y: UInt = 1000000
y - UInt(x)             // 999979</code></pre>

<p>The difference of the two arguments must be representable in the
arguments&#39; type. In the following example, the result of <code>21 - 50</code> is
less than zero, the minimum representable <code>UInt8</code> value:</p>

<pre><code class="language-swift">x - 50                  // Overflow error</code></pre>

<p><strong>Note:</strong> Overflow checking is not performed in <code>-Ounchecked</code> builds.</p>

<p>If you want to opt out of overflow checking and ignore any overflow, use
the overflow subtraction operator (<code>&amp;-</code>).</p>

<pre><code class="language-swift">x &amp;- 50                // 227</code></pre>

<p><strong>Parameters:</strong>
  <strong>lhs:</strong> A numeric value.
  <strong>rhs:</strong> The value to subtract from <code>lhs</code>.</p>

    <h4>Declaration</h4>    
    <code class="language-swift">func -(lhs: UInt64, rhs: UInt64) -&gt; UInt64</code>
    
    
</div></div>
</div>
